home *** CD-ROM | disk | FTP | other *** search
/ Chip: Internet / Chip Internet.iso / wwwutil / webspace.nt / readme.txt < prev    next >
Text File  |  1995-05-15  |  18KB  |  454 lines
  1. README -- 15-May-95 -- WebSpace for Windows 1.0 Beta1
  2.  
  3. Copyright 1995, Template Graphics Software Inc.
  4. All Rights Reserved.
  5.  
  6.  
  7.    *************************************************************************
  8.    * Yes! It's May 15 and this *is* the WebSpace for Windows Beta release! *
  9.    *************************************************************************
  10.  
  11.  
  12. Software Requirements:
  13.  
  14.     To run the WebSpace for Windows 1.0 Beta1 VRML viewer under:
  15.  
  16.     Windows NT  you must have
  17.     ----------
  18.  
  19.         + Windows NT 3.5 or 3.51
  20.  
  21.         + WebSpace for Win32 (see WS32N10B.EXE on our ftp site).
  22.  
  23.         + Standard Microsoft DLLs for the VC++ runtime library, MFC and OLE.
  24.           If you have MSVC++ 2.1 installed then you're all set, otherwise
  25.           you will need to download these (see WIN32DLL.EXE on our ftp site).
  26.  
  27.     Windows 3.1 you must have
  28.     -----------
  29.  
  30.         + Windows 3.1 or 3.11 (WFWG)
  31.  
  32.         + WebSpace for Win32s (see WS32S10B.EXE on our ftp site).
  33.  
  34.           Note: Win32s is a Microsoft subsystem that allows 32 bit programs
  35.           to run in the 16 bit Windows environment.  WebSpace is not a 16 bit
  36.           program and no 16 bit version of WebSpace is planned.
  37.  
  38.         + Standard Microsoft DLLs for Win32s 1.2
  39.           If you have MSVC++ 2.x they are on your installation CD, otherwise
  40.           you will need to download these (see WIN32S.EXE on our ftp site).
  41.  
  42.         + Standard Microsoft DLLs for the VC++ runtime library, MFC and OLE.
  43.           If you have MSVC++ 2.1 installed then you're all set, otherwise
  44.           you will need to download these (see WIN32DLL.EXE on our ftp site).
  45.  
  46.     Windows 95  you must have
  47.     ----------
  48.  
  49.         + Patience!
  50.           WebSpace is based on the OpenGL 3D rendering library which is not
  51.           available yet (look for it shortly after Windows 95 is released).
  52.  
  53.  
  54. Hardware Requirements:
  55.  
  56.     To run the WebSpace for Windows you should have at least:
  57.  
  58.         + A 486/66 processor
  59.  
  60.         + 8 MB memory
  61.  
  62.         + 256 color graphics card
  63.  
  64.     You will soon want to have:
  65.  
  66.         + A Pentium processor
  67.  
  68.         + 24 MB memory
  69.  
  70.         + Fast, high resolution, 24bit TrueColor graphics card
  71.  
  72.     You will be able to take advantage of:
  73.  
  74.         + All display resolution/color combinations supported by Windows
  75.  
  76.         + Multi-processor machines
  77.  
  78.         + OpenGL accelerator cards (Accel, Oki, various GLint-based, etc)
  79.  
  80.  
  81. Installation:
  82.  
  83.     The WebSpace 1.0 Beta1 release does not have an installation program.
  84.     All the download files are self-extracting zip archives (just execute
  85.     the file to unpack its contents).  See the Software Requirements section
  86.     above to determine which files you need to download.
  87.  
  88.     1) The WebSpace installation file (WS32N10B.EXE or WS32S10B.EXE) contains
  89.        the WebSpace executable, the Readme file, the Help files (HTML format)
  90.        and some example VRML files.
  91.  
  92.        Create a new directory, for example "WSBETA1", copy the download file
  93.        into that directory and execute it with the "-d" option.  Like this:
  94.  
  95.            ws32n10b -d
  96.  
  97.        NOTE!  If you don't have two subdirectories "HTML" and "VRML" at this
  98.        point, then you probably forgot to specify the "-d" option.
  99.  
  100.        Copy the startup file "WebSpace.ini" to your Windows directory
  101.        (x:\WINDOWS for Windows 3.1 and %SystemRoot% for Windows NT).  This
  102.        file is used by WebSpace to store its last window size/position and
  103.        other information.
  104.  
  105.     2) If you need the miscellaneous Microsoft DLL's
  106.  
  107.        Download WIN32DLL.EXE into the WebSpace directory and execute the
  108.        program to unpack the files.
  109.  
  110.        ==> Copy the file CTL3D32.DLL into your Windows system directory.
  111.  
  112.        Unlike most DLL's which can be either in the system directory or in
  113.        any directory in the user's path or in the application's working
  114.        directory, CTL3D32.DLL *must* be found in the system directory.
  115.  
  116.        Of course you can copy (or move) all the Microsoft DLL's into the
  117.        system directory if you want to, but it may not be necessary.
  118.  
  119.     3) If you need the Microsoft Win32s DLL's for Windows 3.1
  120.  
  121.        Download WIN32S.DLL into a temporary directory and execute the program
  122.        to unpack the files.  It should create two subdirectories "disk1" and
  123.        "disk2" in the current directory.
  124.  
  125.        Run the "setup" program in the "disk1" directory.  When the installation
  126.        has completed you will have a new program (OK, a game :-) called 
  127.        "FreeCell".  You can run this program to verify that Win32s is correctly
  128.        installed.
  129.  
  130.        Note: There are a number of different versions of Win32s and if you
  131.        already have one installed you must be certain it is v1.2 or newer.
  132.        In the File Manager, open the x:\WINDOWS directory, select the file
  133.        WIN32S16.DLL, then select "Properties" from the File menu and check
  134.        the version number.  If you're not sure, install the newer version.
  135.  
  136.     The WebSpace 1.0 Product release will have a more automated installation.
  137.  
  138.  
  139. Recommended Browser:
  140.  
  141.     Enhanced Mosaic 2.0 from Spyglass
  142.  
  143.       Only known problem is that EMosaic does not pass the URL of the first
  144.       VRML link to WebSpace -- it only passes the name of the temporary local
  145.       file.  This means that WebSpace has no context for resolving relative 
  146.       URLs in the VRML scene.  Once the DDE protocol has been established 
  147.       however (i.e. on second and subsequent links), EMosaic passes the URL to
  148.       WebSpace and relative URLs in the scene work fine.
  149.  
  150.       Configuring EMosaic for WebSpace:
  151.  
  152.         1) Select the "Edit/Helpers" menu item.
  153.         2) Select the "Add" button in the Helpers dialog box.
  154.         3) In the Configure File Type dialog enter:
  155.  
  156.            For Description: VRML Documents
  157.            For MIME type  : x-world/x-vrml
  158.            For Suffixes   : .wrl
  159.            For Encoding   : Text
  160.            For Helper App : <WebSpaceInstallDir>\WebSpace %s
  161.  
  162.  
  163. Other Browsers:
  164.  
  165.     Netscape 1.1
  166.  
  167.       Netscape will start WebSpace but does not pass the URL of the first
  168.       VRML link clicked.  This means that WebSpace has no context for
  169.       resolving relative URLs in the VRML scene.
  170.  
  171.       NOTE: Apparently there are still some problems with the Netscape
  172.       implementation of the DDE protocol, including:
  173.  
  174.         1) The second and subsequent VRML URL's are fetched but are not
  175.            always successfully passed to WebSpace.
  176.  
  177.         2) In some cases, when WebSpace requests a URL from Netscape, the
  178.            Netscape window maximizes itself.
  179.  
  180.       Configuring Netscape for WebSpace:
  181.  
  182.         1) Select the "Options/Preferences" menu item.
  183.         2) Select the "Helper Applications" item in the pulldown.
  184.         3) Click the "New Type" button.
  185.         4) In the Configure New Mime Type dialog enter:
  186.  
  187.            For Mime Type   : x-world
  188.            For Mime Subtype: x-vrml
  189.  
  190.         5) In the "Extensions" field enter: .wrl
  191.         6) In the "Action" group box click "Launch Application"
  192.         7) In text entry field enter: <WebSpaceInstallDir>\WebSpace
  193.  
  194.     Other
  195.  
  196.       Any browser should be able to start WebSpace and pass it a single VRML
  197.       scene (once WebSpace is configured as a helper application).  However
  198.       WebSpace will not be able to fetch URLs associated with WWWAnchor
  199.       nodes in the VRML scene unless the browser supports the Mosaic DDE
  200.       protocol and has been registered with WebSpace.  Also, if the browser
  201.       does not support the DDE protocol then each time you select a VRML
  202.       link in the browser, it will start a new copy of WebSpace.
  203.  
  204.  
  205. Help Files
  206.  
  207.     Help files are provided in the WebSpace installation directory.
  208.     They are in HTML format and may be viewed with your Web browser.
  209.  
  210.  
  211. Example VRML files
  212.  
  213.     Example VRML files are provided in the WebSpace installation directory.
  214.     They may loaded directly into WebSpace or through your Web browser.
  215.  
  216.     For example, type: WebSpace urlHouse.wrl
  217.  
  218.  
  219. Tips
  220.  
  221.     1) Viewers
  222.  
  223.        WebSpace provides two different 3D viewers:
  224.  
  225.        Walk Viewer (the default): For 3D scenes
  226.        Examiner Viewer          : For 3D objects
  227.  
  228.        VRML files should contain a "Viewer" hint that tells WebSpace which
  229.        viewer to use by default.  But in some cases it may be necessary to
  230.        change viewers manually using the "View" menu.
  231.  
  232.        You can tell which viewer is active by looking in the window banner
  233.        or by looking at the dashboard.  The Walk viewer has a "T bar" type
  234.        joystick for maneuvering and the Examiner viewer has a track ball.
  235.  
  236.     2) The Mouse
  237.  
  238.        In WebSpace, the mouse button (with no modifier keys) is used only
  239.        to select "hot" objects (links) and to manipulate the dashboard.
  240.        See the Help file (HTML format) for details on the dashboard controls,
  241.        mouse buttons, modifier keys and keyboard shortcuts.
  242.  
  243.        Open Inventor users note!  This is different from the default mouse
  244.        action in standard Open Inventor viewers.  Holding down the "Ctrl"
  245.        key makes the mouse button work like what you're used to doing with
  246.        the left mouse button.
  247.  
  248.     3) Hot Objects
  249.  
  250.        WebSpace highlights "hot" objects (WWWAnchor nodes) that are links
  251.        to other URLs by changing their color when the cursor moves over
  252.        them (it also displays the URL associated with the link in the status
  253.        bar at the bottom of the window).  These "hot objects" are just like
  254.        the links in an HTML document.  Click on the "hot object" while it is
  255.        highlighted to go to that URL.  You can also highlight all the links
  256.        simultaneously using the "Options/Show Hot Links" menu item.
  257.  
  258.        Note however that hot objects are *not* highlighted while you are
  259.        moving in the Walk viewer (have the mouse button down), rotating the
  260.        object in the Examimer viewer (have the mouse button down) or while
  261.        the object is spinning in the Examiner viewer (hint: click the blue
  262.        trackball to stop spinning).
  263.  
  264.     4) Inline Objects
  265.  
  266.        Sometimes you will see "empty boxes" when a scene first comes up.
  267.        Usually these are "inline objects" (WWWInline nodes).  Inlined objects
  268.        are defined in separate VRML files which are referenced from the main
  269.        VRML file.  They display as a bounding box until the viewer finishes
  270.        fetching the contents of the file.  The effect of this is similar to
  271.        the way some HTML viewers display the text of a page while they are
  272.        still fetching the images.
  273.  
  274.        If an inline object is also a link (a "hot object"), its bounding box
  275.        will highlight just like any other hot object and you can click on the
  276.        bounding box to follow that link.
  277.  
  278.     5) ViewPoints
  279.  
  280.        WebSpace supports the VRML "Cameras" hint which allows a VRML author
  281.        to predefine named camera positions, or viewpoints.  The WebSpace
  282.        "ViewPoints" menu is dynamically created every time a VRML scene is
  283.        loaded and allows you to select any of the predefined viewpoints.
  284.        This is particularly helpful in a complex scene where "walking"
  285.        around using the viewer controls is too slow.
  286.  
  287.        By default WebSpace will "jump" to the selected viewpoint.  This was
  288.        selected as the default because it works better on slower machines.
  289.        You can change this behavior by disabling the "View/Jump Cuts" menu
  290.        item.  Then WebSpace will attempt to move "smoothly" to the selected
  291.        viewpoint by interpolating the camera position along a spline.
  292.  
  293.     6) Inventor Files
  294.  
  295.        WebSpace also supports the full Open Inventor file format.  These
  296.        files are identified by the extension ".iv" and may contain nodes
  297.        that are not (or at least not yet) allowed in VRML files.  Inventor
  298.        nodes include 2D text, 3D text and "engines" that define various
  299.        types of predefined motion in the scene.
  300.  
  301.  
  302. Initial URL
  303.  
  304.     All the browsers we have tested so far have the problem that they do not
  305.     pass the URL of the first link to the helper application (only the name
  306.     of the temporary local file).  As a result WebSpace has no base URL to
  307.     use to resolve relative URLs in the VRML scene.
  308.  
  309.     If you are using a browser that supports the Spyglass DDE protocol, e.g.
  310.     Enhanced Mosaic 2.0, you can work around this problem by selecting the
  311.     same link a second time in the browser.  This works because all links
  312.     after the first one are passed to WebSpace using the DDE protocol.
  313.  
  314.     Encourage your browser vendor to pass URLs to helper applications!
  315.  
  316.     The VRML community is considering adoption of BASE_URL as a standard
  317.     "hint" that VRML authors could incorporate in their file to provide this
  318.     information to the VRML viewer independent of the browser.  WebSpace will
  319.     support this hint in the next release and we encourage VRML authors to
  320.     use it.  The BASE_URL hint has the following form:
  321.  
  322.             DEF BASE Info {
  323.                 string "http://www.something.com/somefile.wrl"
  324.             }
  325.  
  326.  
  327. Messages
  328.  
  329.     "WWW_RegisterViewer returned fail status."
  330.  
  331.         This normally means that no HTML browser is running or at least
  332.         WebSpace does not recognize the browser as a candidate for the
  333.         DDE protocol.  WebSpace will still work as a standalone viewer for
  334.         local files.
  335.  
  336.  
  337. Known Problems
  338.  
  339.     1) WebSpace started before HTML browser
  340.  
  341.         When WebSpace is started manually before the HTML browser, the
  342.         browser will not recognize that WebSpace is already running and
  343.         will start another instance (if a VRML link is clicked).  It is
  344.         not known yet whether this is a browser or WebSpace problem.
  345.  
  346.     2) WebSpace exits before HTML browser
  347.  
  348.        When WebSpace exits before the HTML browser (whether intentionally
  349.        or not :-), the DDE protocol is hosed and the browser is no longer
  350.        able to start WebSpace.  Exit and restart the browser to work around
  351.        this problem.
  352.  
  353.     3) Window resizing
  354.  
  355.        Window resizing does not work correctly when the Examiner viewer is
  356.        selected (main window resizes but drawing area does not).  Switch to
  357.        the Walk viewer and back, if necessary, to work around this problem.
  358.  
  359.     4) Incorrect colors
  360.  
  361.        The Windows 3.1 version of WebSpace does not draw the correct colors
  362.        on a 24bit TrueColor display.  It works correctly if the display is
  363.        switched to a 256 color mode.  The Windows NT version of WebSpace
  364.        does not have this problem and works well on 24bit displays.
  365.  
  366.     5) Dashboard obscured
  367.  
  368.        In some cases graphics in the scene may be drawn on top of the
  369.        dashboard.  This problem is being investigated.
  370.  
  371.     6) WebSpace crashs
  372.  
  373.        Yep.  Still happens some times.  We're working on it.
  374.  
  375.  
  376. Not Implemented in Beta1 Release
  377.  
  378.     Menu items that are "grayed out" are not implemented yet.
  379.  
  380.     The keyboard shortcuts.
  381.  
  382.  
  383. Compared to WebSpace on UNIX:
  384.  
  385.     1) WebSpace for Windows does not currently fetch URLs directly, but
  386.        instead relies upon a Web browser that supports the Spyglass DDE
  387.        protocol.  Therefore WebSpace cannot be used as a standalone Web
  388.        browser (although it can be used standalone to view local files).
  389.  
  390.        Note however that by fetching URLs through a general purpose Web
  391.        browser, WebSpace provides the ability to handle many types of
  392.        URLs linked through the VRML scene.  For example, if a link in a
  393.        VRML scene is to an audio file URL, WebSpace will request the Web
  394.        browser to fetch the file and the Web browser will route it to an
  395.        appropriate helper application.
  396.  
  397.     2) The default setting for "Jump Cuts" is TRUE in WebSpace for Windows.
  398.  
  399.  
  400. -----------------------------------------------------------------------------
  401.  
  402. Registration for WebSpace v1.0b1 (beta 1) Support
  403.  
  404.  
  405.     Template Graphics Software has partnered with Silicon Graphics Inc.
  406.     in the development of WebSpace.  WebSpace v1.0b1 is available free
  407.     for personal use from various ftp sites.  This is an unsupported
  408.     version.  Comments may be mailed to:
  409.  
  410.         webspace@tgs.com
  411.  
  412.     but do not expect a reply to these messages.
  413.  
  414.     If you would like to purchase support for WebSpace for $49.00 per copy,
  415.     please contact Template Graphics Software at 619.457.5359 x233, or mail
  416.     a check or money order, payable to Template Graphics Software, Inc., to:
  417.  
  418.         WebSpace Support
  419.         Template Graphics Software
  420.         9920 Pacific Heights Blvd., Suite 200
  421.         San Diego, CA 92121
  422.  
  423.     A secure transaction form will be added to the TGS home page located
  424.     at http://www.sd.tgs.com/~template/WebSpace eventually.
  425.  
  426.     WebSpace Support is $49.00 per copy for all platforms.  Once you have
  427.     registered, you will be entitled to the following:
  428.  
  429.         + 30 days 2-way email technical support
  430.           (TGS Hotline will call you if needed)
  431.  
  432.         + Access to password-protected VRML pages
  433.           (For verification and fun)
  434.  
  435.         + Access to follow-on beta releases
  436.  
  437.         + Free upgrade to WebSpace v1.0 final (July 15, a $99 value)
  438.  
  439.  
  440. -----------------------------------------------------------------------------
  441.  
  442. Thanks for using WebSpace!
  443.  
  444. Really.  We appreciate you checking it out, 'cause we're not making a lot of
  445. money off of this thing, we really want VRML to be successful at whatever it
  446. is it's struggling to become.  So, you know, don't just tell us it's "broken"
  447. (heck, we know it's still got bugs, we wrote it! :-), tell us things we can
  448. do to make it better.
  449.  
  450. See you in Cyberspace, 
  451.  
  452. -- The TGS WebSpace Team
  453.  
  454.